home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d10 / logchk12.arc / LOGCHEK.DOC < prev    next >
Text File  |  1991-04-28  |  13KB  |  328 lines
  1.             ┬─┬──                 ┌─┬─────┐
  2.             │ │                   │ │
  3.             │ │       ┌┬──┐ ┌┬─── │ │       ┬┬  ┬ ┬┬──┐ ┬┬ ┌─
  4.             │ │       ││  │ ││ ┌┐ │ │       │├──┤ │├─   │├─┴┐
  5.             ┴─┴─────┘ └┴──┘ └┴──┘ └─┴─────┘ ┴┴  ┴ ┴┴──┘ ┴┴  ┴
  6.  
  7.  
  8.  
  9.                            ┬┬  ┬  ┬┐    ┌──┬┐
  10.                            ││ ┌┘  ││    ┌┬─┴┘
  11.                            └┴─┘  ─┴┴─ o └┴──┘
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                              April 20, 1991
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                A PCBoard 14.5A CALLER Log Viewing Program
  29.  
  30.                   (C) Copyright 1991, Michael S. Nelson
  31.  
  32.                            All Rights Reserved
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                            SYSOP - SeaHunt BBS
  45.                    Burlingame, CA (415)344-4348 *HST*
  46.                    FidoNet 1:125/20, RBBSNet 8:914/501
  47.  
  48.  
  49.  
  50. LogChek - PCBoard CALLER log viewer                              Page 2
  51.  
  52. ┌──────────────┐
  53. │ INTRODUCTION │
  54. └──────────────┘
  55.  
  56.      Like most PCBoard  sysops, I used  to use Vern  Beurg's LIST.COM (yes,  I
  57. registered it LONG  ago <grin>) to  view my PCBoard  CALLER logs.   LIST works
  58. great, but it  always starts at  the beginning of  the log if  you don't use a
  59. command line switch.  When I come home from work, I want to take a quick  look
  60. at what happened on the system during the day, and that information is at  the
  61. end of the CALLER log, not the beginning.
  62.  
  63.      I  also  missed  the  use  of  color  to  highlight  particular  types of
  64. transactions in the log that was introduced with PCBoard 14.5... but I  didn't
  65. want to have  to do a  local logon to  the system in  order to use  PCBoard to
  66. show me the log with the "13 1"  and "13 2" commands.  So, I decided  to write
  67. LogChek.
  68.  
  69.      LogChek will  show you  your caller  logs in  reverse order, like PCBoard
  70. does, and it also highlights different classes of events in different  colors.
  71. For instance,  all security  violations are  shown in  BRIGHT RED  on a  BLACK
  72. background, so they are really obvious.   When a user opens a DOOR, that  line
  73. is shown in BRIGHT GREEN.   DOWNLOADS are shown in BRIGHT YELLOW,  and UPLOADS
  74. are shown in BRIGHT WHITE.  When a brand new caller calls in it will show  his
  75. logon in BRIGHT MAGENTA.   Other colors are used  to emphasise other types  of
  76. activity.   You'll quickly  get the  hang of  it.   All the  everyday, mundane
  77. messages are shown in the default LIGHTGREY on BLACK, just as if you  executed
  78. the "TYPE CALLER1" command in DOS.
  79.  
  80. ┌──────────────────┐
  81. │ ACKNOWLEDGEMENTS │
  82. └──────────────────┘
  83.  
  84.      Thanks  to  Fred  Clark,  David   Terry,  Cam  DeBuck,  and  the   others
  85. responsible for the wonderful program that is PCBoard 14.5A!!
  86.  
  87.      Thanks to Richard Couture and Dean  Brunette for help on the code  of the
  88. program!
  89.  
  90.      And, thanks to the beta testers:
  91.  
  92.      Bob Jacobson of Higher Powered BBS           (408) 737-9447
  93.      Tom Swegles of Charisma BBS                  (415) 349-7402
  94.      Peter Wadsworth of Coconino County BBS       (415) 861-8290
  95.      Michael Dew of CannonFodder BBS              (404) 860-0367
  96.      .\\ichele Hamilton of Sunshine PCBoard       (305) 432-2223
  97.  
  98.  
  99.  
  100. LogChek - PCBoard CALLER log viewer                              Page 3
  101.  
  102. ┌───────────────────────────────┐
  103. │ PREPARATION AND CONFIGURATION │
  104. └───────────────────────────────┘
  105.  
  106.      Since one of the major reasons for my writing LogChek was to display  the
  107. CALLER  logs  in  color,  no  provisions  have  been  made  for  those running
  108. monochrome video  setups.   If you  are running  monochrome, LogChek  probably
  109. won't work well for you.
  110.  
  111.      The command line to run LogChek is:
  112.  
  113.           "LOGCHEK C:\PCB\MAIN\CALLERx"
  114.  
  115.      where C:\PCB\MAIN\CALLERx is the  complete Drive:Path\Name of the  CALLER
  116. log you want to display.
  117.  
  118.      Since  I  have  not  yet  implemented  the  ability  for  LOGCHEK to read
  119. PCBoard's  configuration  files  to  determine  what  CALLER logs to read, you
  120. might want to run  it from a batch  file, as I do.   I keep LogChek.exe in  my
  121. C:\PCB directory, which is in my PATH, so my LC.BAT file looks like this:
  122.  
  123.                @echo off
  124.                c:
  125.                cd\pcb
  126.                logchek c:\pcb\main\caller1
  127.                logchek c:\pcb\main\caller2
  128.                exit
  129.  
  130.      The reason for  the "exit" in  the last line  is that I  run LogChek in a
  131. 128k DESQview window,  and I want  the window to  automatically close after  I
  132. view the second node's log.
  133.  
  134.      When  LogChek  first  loads,  there  is  a  slight delay as it loads your
  135. chosen CALLER  file into  memory.   After that,  the file  is closed,  and all
  136. further processing is done in memory.  Note that at the present time,  LogChek
  137. will  only  display  the  LAST  650  lines  of  your CALLER log, due to memory
  138. constraints (and  my neophyte  programmer status  <grin>).   A future  release
  139. will have the ability to read the entire file.
  140.  
  141.      There's a popup  HELP screen accessable  by typing ALT-H  or F1, and  you
  142. exit from the program with ESC or ALT-H.  To scroll up and and down, use  your
  143.  and  keys.  You can PAGE up and down with your PageUp and PageDn keys.   Go
  144. to the beginning or the end of the display buffer with your HOME or END  keys.
  145. This version  has a  KEYWORD SEARCH  function, too...  press ALT-F  to use it.
  146. Ctl-L or F3 repeats the last search. Alt-A is the program info screen.
  147.  
  148.      LogChek is written  in Borland C++,  and compiled with  the TCXL v5.52  C
  149. windowing library,  so it  is DV-Aware,  and will  write to  DESQview's screen
  150. buffer.  It also opens your CALLER logs in SHARED, READONLY, DENYNONE  mode...
  151. so it is important  that you have DOS's  SHARE.EXE installed if you  are going
  152. to run LogChek under a MultiTasker or a NetWork.
  153.  
  154.  
  155. LogChek - PCBoard CALLER log viewer                              Page 4
  156.  
  157. ┌────────────────┐
  158. │ DESQview SETUP │
  159. └────────────────┘
  160.                               Change a Program
  161.  
  162. Program Name............: LogChek
  163.  
  164. Keys to Use on Open Menu: LC                         Memory Size (in K): 128
  165. ─────────────────────────────────────────────────────────────────────────────
  166. Program...: g:\batch\lc.bat
  167.  
  168. Parameters:
  169.  
  170. Directory.: c:\pcb\main
  171. ─────────────────────────────────────────────────────────────────────────────
  172. Options:
  173.                  Writes text directly to screen.......: [Y]
  174.                  Displays graphics information........: [N]
  175.                  Virtualize text/graphics (Y,N,T).....: [N]
  176.                  Uses serial ports (Y,N,1,2)..........: [N]
  177.                  Requires floppy diskette.............: [N]
  178.  
  179. ---------------------------------------------------------------------------
  180.                      Change a Program Advanced Options
  181.  
  182. System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  183.  
  184. Script Buffer Size.......:  1000   Maximum Expanded Memory Size (in K):
  185.  
  186. Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  187. ────────────────────────────────────────────────────────────────────────────
  188. Window Position:
  189.    Maximum Height:  25       Starting Height:  25       Starting Row...:   0
  190.    Maximum Width.:  80       Starting Width.:  80       Starting Column:   0
  191. ────────────────────────────────────────────────────────────────────────────
  192.                                Shared Program
  193. Pathname..:
  194. Data......:
  195. ────────────────────────────────────────────────────────────────────────────
  196. Close on exit (Y,N,blank)......: [N]  Uses its own colors..............: [Y]
  197. Allow Close Window command.....: [Y]  Runs in background (Y,N,blank)...: [ ]
  198. Uses math coprocessor..........: [Y]  Keyboard conflict (0-F)..........: [0]
  199. Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  200. Can be swapped out (Y,N,blank).: [ ]  Protection level (0-3)...........: [0]
  201.  
  202.      So, with this setup, and the LC.BAT file shown on the previous page,
  203. just tap your DESQ key, type CV <ENTER>, and you'll be viewing your logs.
  204.  
  205.  
  206. LogChek - PCBoard CALLER log viewer                              Page 5
  207.  
  208. ┌──────────────────────────────────────┐
  209. │ LICENSING AND DISTRIBUTION AGREEMENT │
  210. └──────────────────────────────────────┘
  211.  
  212. Copyright (C) 1991 by Michael S. Nelson of SeaHunt BBS.
  213.  
  214. ALL RIGHTS RESERVED.   COMMERCIAL DISTRIBUTION AND/OR  USE PROHIBITED  WITHOUT
  215. WRITTEN PERMISSION FROM MICHAEL S. NELSON OF SEAHUNT BBS.
  216.  
  217. Non-Commercial  distribution  and/or  use  is  permitted  under  the following
  218. terms:
  219.  
  220.      1.  You may copy and distribute copies of LogChek executable code as  you
  221.          receive it,  in any  medium, provided  that you  do so  in a  lawful,
  222.          friendly manner.
  223.  
  224.      2.  You  must  keep  this  License  Agreement  intact  and give any other
  225.          recipients of the  LogChek program a  copy of this  License Agreement
  226.          along with the program.
  227.  
  228.      3.  You must distribute LogChek in  unmodified form.  You may not add  an
  229.          advertisement  for  your  Bulletin  Board  System,  User  Group,   or
  230.          anything else  as a  file in  the distribution  packet.   You may not
  231.          add, modify or  delete any of  the files in  the LogChek distribution
  232.          archive.
  233.  
  234.      4.  LogChek  must  be  distributed  for  free.   You  may  not  charge a
  235.          distribution fee for the physical act of transferring a copy of  this
  236.          program.   You  may  not  place  this  program  in any file area of a
  237.          Bulletin Board  System if  a fee  is required  to download  from that
  238.          area.
  239.  
  240.      5.  LogChek may not be distributed  in any way as part of a  package that
  241.          is  part  of  a  sales  transaction  whether  that  package  be other
  242.          software or  hardware, such  as a  modem, CD-ROM,  Hard Drive, or any
  243.          software collections.
  244.  
  245.      6.  You may not modify your  copy or copies of LogChek or any  portion of
  246.          it and you  can not copy  and distribute any  modifications.  LogChek
  247.          is distributed in ZIP format  and it is preferred (but  not required)
  248.          that you leave it in that format.
  249.  
  250.  
  251. LogChek - PCBoard CALLER log viewer                              Page 6
  252.  
  253.      7.  You may not  copy, sublicense, distribute or transfer  LogChek except
  254.          as  expressly  provided  under  this  License Agreement.  Any attempt
  255.          otherwise  to  copy,  sublicense,  distribute  or transfer LogChek is
  256.          void and your rights to use the program under this License  agreement
  257.          shall be automatically terminated.
  258.  
  259.      8.  You may not incorporate parts of LogChek into other programs  without
  260.          the written permission of Michael S.  Nelson.  Permission may or  may
  261.          not be granted based upon a determination of your intended use.
  262.  
  263.      9.  You  may use the  software only after  understanding and agreeing  to
  264.          the above terms.
  265.  
  266. ┌─────────────┐
  267. │ NO WARRANTY │
  268. └─────────────┘
  269.  
  270.    LOGCHEK IS  LICENSED FREE  OF CHARGE  AND THERE  IS ABSOLUTELY NO WARRANTY.
  271.    MICHAEL S.  NELSON, SEAHUNT BBS AND ANY OTHER PERSONS THAT MAY BE  INVOLVED
  272.    IN THE DISTRIBUTION OF LOGCHEK PROVIDE LOGCHEK "AS IS" WITHOUT WARRANTY  OF
  273.    ANY KIND, EITHER EXPRESSED OR  IMPLIED, INCLUDING, BUT NOT LIMITED  TO, THE
  274.    IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A   PARTICULAR
  275.    PURPOSE.
  276.  
  277.    THIS PROGRAM  IS GUARANTEED  TO DO  ABSOLUTELY NOTHING  BUT OCCUPY SPACE ON
  278.    YOUR DISC.  USE IT AT YOUR OWN RISK.
  279.  
  280.  
  281.  
  282. LogChek - PCBoard CALLER log viewer                              Page 7
  283.  
  284. ┌───────────────────┐
  285. │ TECHNICAL SUPPORT │
  286. └───────────────────┘
  287.  
  288.      Since  LogChek  is  provided  free  of  charge,  there is no guarantee of
  289. technical support.  However, you may  contact me by FIDONET e-mail or  RBBSNet
  290. e-mail at  the address  listed on  the cover  sheet of  this documentation.  I
  291. also  monitor  several  PCBoard  conferences  on  Intelec, RIME, SmartNet, and
  292. FidoNet.  Last, but  not least, you can  reach me in the  UTILITIES conference
  293. on SaltAir BBS.
  294.  
  295.      If you  have any  suggestions on  how to  improve the  program, or if you
  296. have  any  bugs  to  report,  I'd  like  to  hear from you.  Please direct any
  297. complaints to /DEV/NULL.
  298.  
  299.  
  300.  
  301.  
  302.  
  303. ┌─────────────────┐
  304. │ RELEASE HISTORY │
  305. └─────────────────┘
  306.  
  307.   Version 1.00   First PUBLIC release 04-04-91 as "CallView"
  308.  
  309.   Version 1.10   Added  additional  colorization  keywords, exploding  viewing
  310.                  window, HOME and END key functions.
  311.  
  312.   Version  1.20  Cleaned  up  the  user interface, added  KEYWORD  searching,
  313.                  now  compiled  under  the  new  Borland C++ with TCXL 5.52.02
  314.                  C library.  Name changed  to LogChek  due to  a name conflict
  315.                  with a similar program for WildCat! caller logs
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. **** END DOCUMENTATION for LogChek ****